# GPS data video

This project contains Python scripts that transform GPS data (lat, lon)
and speed into mp4 videos that can be used as overlays when editing
videos from an action cam. These videos are png encoded.

Additional to the Python scripts there are two bash scripts. One scales
and changes frame rate of the GPS-derived video. The second one overlays
GPS-derived video on a background video.

The GPS data source is a SONY action cam and the code is tailored
for the file format SONY use.

List of scripts (located in the code directory):

* ReadNMEA.py
* GPS2Speedmp4.py
* GPS2Trackmp4.py
* scaleGPSvid.bash
* overlayGPSvid.bash

# Dependencies

* Python 3
* numpy
* matplotlib
* ffmpeg

# Usage

No GUI, all CLI:

`GPS2Speedmp4.py infile outfile`

`GPS2Trackmp4.py infile outfile`

`scaleGPSvid.bash infile new_framerate new_width outfile`

`overlayGPSvids.bash basevid overelay1 overlay2 outvid`

Currently the placement of overlay1 and overlay2 are hard-coded.
Frame rates must be the same in all three videos,

/Martin Schöön, Oct. 10, 2024
